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1. Node Debug 三 法 三 例 


作者 : i5ting 
7$ : node-debug tutorial 


大 家 对 nodejs 调 试 应 该 都 比较 头疼 ， 至 少 我 这 个 不 用 IDE 写 js 的 人 很 头疼 这 个 ， 其 实 node 的 生 
BAFRA 有 非常 好 的 工具 和 非常 潮 的 开发 方式 


这 里 总 结 了 3 法 3 例 ， 硕 望 能 对 大 家 有 所 帮助 
3 种 方法 


e node debugger 
e node inspector 
e 测试 驱动 开发 


3 个 例子 


e hello world 
e 继承 例子 
e express helloworld 


1.1. node debug 


V8 提供 了 一 个 强大 的 调试 器 ， 可 以 通过 TOP 协议 从 外 部 访问 。Nodejs 提 供 了 一 个 内 建 调试 
器 来 帮助 开发 者 调试 应 用 程序 。 想 要 开启 调试 器 我 们 需要 在 代码 中 加 入 debugger 标 签 ， 当 
Nodejs 执 行 到 debugger 标 签 时 会 自动 暂停 (debugger 标 签 相 当 于 在 代码 中 开启 一 个 断 点 ) 。 
1.1.1. hello world 例 子 


代码 如 下 : 


See helloword-debug.js 


var hello - 'hello'; 

var world - 'nodejs'; 

debugger; 

var hello_world = hello + ' ' + world; 


console.log(hello world); 


执行 命令 : node debug helloword-debug.js 就 可 以 进入 调试 模式 。 


当然 ， 首 先 需 要 在 程序 代码 中 手动 添加 中 断 debugger; > 这样 当 以 调试 模式 运行 时 ， 程 序 会 
自动 中 断 ， 然 后 等 候 你 调试 ， 就 像 GDB 一 样 ， 可 以 用 help 命 令 查看 自己 都 可 以 使 用 哪些 调试 


命令 。 


node-debug-tutorial git:(master) ? node debug helloword-debug.js 
< debugger listening on port 5858 
connecting... ok 
break in helloword-debug.js:1 
1 var hello - 'hello'; 
2 var world - 'nodejs'; 
3 
debug» help 
Commands: run (r), cont (c), next (n), step (s), out (0o), backtrace (bt), setBreakpoint ( 
watch, unwatch, watchers, repl, restart, kill, list, scripts, breakOnException, breakpoin 
debug» 
debug» n 
break in helloword-debug.js:2 
1 var hello - 'hello'; 
2 var world - 'nodejs'; 
3 
4 debugger; 
debug» repl 
Press Ctrl + C to leave debug repl 
» hello 
'hello' 


[EN 0 f 


此 时 repl 打 开 js 上 下 文 即 时 求 值 环境 ， 和 chrome 的 debug 的 console 是 一 样 的 。 





如 果 想 退出 ， 请 按 下 ctrl + c ,这 样 就 可 以 返 到 debug 模 式 


debug» n 
break in helloword-debug.js:4 
2 var world - 'nodejs'; 
3 
4 debugger; 
5 
6 var hello world = hello + ' ' + world; 
debug» n 
break in helloword-debug.js:6 
4 debugger; 


5 
6 var hello world = hello + ' ' + world; 
7 console.log(hello world); 
8 
debug» n 
break in helloword-debug.js:7 
5 
6 var hello world = hello + ' ' + world; 
7 console.log(hello world); 
8 
9 3); 


debug» repl 

Press Ctrl + C to leave debug repl 
» hello world 

'hello nodejs' 

> 


end 
如 果 想 终止 调试 ， 请 按 下 2 次 ctrL + c 键 


1.1.2. 命令 说 明 


run 

restart 

cont, c 

next, n 

step, s 

out, o 

setBreakpoint(), sb() 
setBreakpoint('f()), sb(...) 
setBreakpoint('script.js', 20), sb(...) 
clearBreakpoint, cb(...) 
backtrace, bt 

list(5) 

watch(expr) 
unwatch(expr) 

watchers 

repl 

kill 

scripts 


version 
这 里 就 和 gdb 等 调试 器 一 模 一 样 了 
回归 一 下 ，debug 的 2 种 模式 : 


。js 上 下 文 即时 求 值 环境 模式 
e debug 断 点 模式 


八卦 一 下 啊 ， 你 了 解 vi 的 3 种 工作 模式 么 ? 


e 普通 (normal) 模 式 ， 又 称 命令 模式 
e 插入 (insert) 模 式 


e 
E 


4r 4-11 (cmdline A 
化 用 一 下 更 容易 理解 


node debugger 官 方 文档 


用 途 
执行 脚本 ,在 第 一 行 暂停 
重新 执行 脚本 
继续 执行 ,直到 遇 到 下 一 个 断 点 
单 步 执行 
单 步 执行 并 进入 函数 
从 函数 中 步 出 


当前 行 设置 断 点 

在 函数 {的 第 一 行 设置 断 点 

在 script.js 的 第 20 行 设置 断 点 
清除 所 有 断 点 

Xi pem 

显示 当前 执行 到 的 前 后 5 行 代码 
把 表达 式 expr 加 入 监视 列表 

把 表达 式 expr 从 监视 列表 移 除 
显示 监视 列表 中 所 有 的 表达 式 和 值 
在 当前 上 下 文 打开 即时 求 值 环境 
终止 当前 执行 的 脚本 

显示 当前 已 加 载 的 所 有 脚本 
显示 V8 版 本 


fi || nodejs.org/api/debugger.html 


nède 
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上 面 有 更 多 的 例子 和 api， 有 了 上 面 的 基础 ， 学 习 会 非常 简单 。 
1.1.3. FAQ 
注意 ,如 果 出 现 
< Failed to open socket on port 5858, waiting 1000 ms before retrying 


请 结束 掉 所 有 debug 进 程 


ps -ef|grep debug-brk|awk '{print $2}'|xargs kill -9 


1.2. node inspector 


这 种 方式 稍微 有 些 麻 烦 ， 作 为 前 端 开 发 人 员 ， 我 们 写 JS 代 码 调 试 的 时 候 一 般 都 用 FireBug 
NE 览 器 内 置 的 调试 工具 ， 其 实 nodejs 程 序 也 可 以 这 样子 来 调试 ， 但 是 首先 需要 安装 
一 个 node-inspector 的 模块 。 


node-inspector 是 通过 Websocket 方 式 来 转向 debug 输 入 输出 的 。 因 此 ， 我 们 在 调试 前 要 先 启 
动 node-inspector 来 监听 Nodejs 的 debug 调 试 端口 。 
1.2.1. 安装 


这 个 需要 用 npm 来 安装 ， 只 需要 执行 下 列 语 钉 : 


npm install -g node-inspector 
安装 完成 之 后 ， 通 常 可 以 直接 这 样 启动 在 后 台 : 
node-inspector & 


默认 会 监听 8080 端 口 ， 当 然 ， 也 可 能 通过 使 用 --web-port 参 数 来 修改 。 然 后 ， 在 执行 hode 程 
序 的 时 候 ， 多 加 个 参数 : --debug-brk, 如 下 : 


node --debug-brk app.js 


或 者 
node-debug app.js 
控制 台 会 返回 “debugger listening on port 5858”， 现 在 打开 浏览 器 ， 访 问 


http://localhost:8080/debug?port=5858， 这 时 候 就 会 打开 一 个 很 像 Chrome 内 置 调试 工具 的 界 
面 ， 并 且 代 码 断 点 在 第 一 行 ， 下 面 就 可 以 使 用 这 个 来 调试 了 。 


常用 调试 功能 


e 增加 断 点 ， 查 看 调用 栈 ， 变 量 等 
e 使 用 console 打 印 查看 日 志 


使 用 方法 和 chrome 的 inspect element 调试 web 开 发 是 一 样 的 


调试 还 是 很 方便 的 ， 而 且 可 以 远程 调试 。 其 实 原理 很 简单 ， 它 启动 的 是 一 个 web server， 我 们 
要 做 的 就 是 把 localhost 换 成 对 应 ip 即 可 ， 要 注意 服务 器 的 防火 墙 哦 。 
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1.2.2. 测试 extend.js 
测试 一 下 继承 是 否 ok， 首 先 执行 命令 ， 打 印 出 结果 ， 但 这 种 办 法 才 挫 了 


? node-debug-tutorial git:(master) node extend.js 
node debug 
hello node debug 


开始 使 用 node-inspector 调 试 
1.2.2.1. 启动 


? node-debug-tutorial git:(master) node-debug extend.js 
Node Inspector is now available from http://localhost:8080/debug?port-5858 
Debugging 'extend.js^ 


debugger listening on port 5858 


1.2.2.2. 界面 说 明 

















Sources | Contents... Snippets | extend.js x | module.js Ib | || 全 [73 























> © (no domain) 1 (function(exports, require, module, — filename, | dirname) 4 > Watch Expressions 
xis function base() 1 
v Gfile/ this.name - "node debug"; Aah 
v (-3Users/sang/workspace/githul] this.say n Tune u i i 
» © node, modules y console.log('hello ' + this.name); anonymous function) SEREG 
* 自 preview } Module._compile module.js:462 
enc er function test() { Module, extensions..js module.js:480 
=) extend.js base. call 
=) gulpfile.js Module.load module.js:362 
«| helloword-debug.js var t = new test(); Module. load module.js:317 
= helloword.js console. log(t. name] ; Module.runMain module.js:503 


t,say(); 
i T listOnTimeout timers.js:112 


Paused on a JavaScript breakpoint. 


源码 目录 代码 编辑 器 ds jit 断 点 信息 区 


» Closure 








Object 


iV express-helloworld.j5:5 
res.send( 'hello,world'); 























Q { Line 10, Column 1 


”日志 打印 区 








zo vY jem www vm aa ”同志 以 及 调试 设置 区 0000000000000 w 


Symbol Key 
? Command Key 
f Control Key 
? Option Key 
? Shift Key 
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断 点 操作 
e resume script execution (F8) 挂 起 断 点 ， 也 可 以 理解 为 放弃 当前 断 点 ， 如 果 有 下 一 个 
断 点 ， 会 自动 断 住 得 
e step over (F10) 跳 过 这 行 ， 到 下 一 行 ， 如 果 当 前 函数 结束 ， 会 跳 到 调用 栈 的 上 一 级 的 
下 一 行 
e step into (F11) 进入 当前 行 代码 里 的 函数 内 部 
e step out (Shift + F11) 从 当前 函数 退出 到 之 前 进入 的 代码 处 
控制 台 操作 


e 不 能 使 用 var， 直 接 打印 变量 杰克 


1.2.2.3. 增加 断 点 ， 并 打印 出 this 












































Sources | Content s... Snippets 四 | extend.js x | express-helloworld.js module.js vii! 
> (2 (no domain) 1 (function (exports, require, module, _ filename, _ dirname) { function base() 4 
v Q file: 2 this.name - "node debug"; 
ile:// 3 this.say = function() { 
v -3Users/sang/workspace/github 4 console.log('hello ' + this.name); 
POT node modules A } 
站 preview 7 . 
E] express-helloworld.js 8 function test() { 
司 extend.js 10 
=) gulpfile.js 11 
== . 12|var t = new test(); 
= helloword-debug.js 13 console. log(t.name); 
E] helloword.js 14 t.say(); 
15| }); 











D {} Line9, Column 1 


» this 
v test 四 
» proto : test 
> | 


1.2.2.4. 断 点 下 一 步 ， 并 打印 出 this 
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Sources | Content s... Snippets |l! |[[<| extend.js x | express-helloworld.js module.js >|j| 
> ®© (no domain) 1 (function (exports, require, module, _ filename, — dirname) { function base() { 
v Q file: 2 this.name - "node debug"; 
ile:// 3 this.say = function() { 
vO Users/sang/workspace/githut 4 console.log('hello ' + this.name); 
> C node modules 2 } } 
pO preview 


7 
8| function test() { 


express-helloworld.js base.call(this); 
extend.js ee 


图 加 图 加 图 





11 
gulpfilejs . 12|var t = new test(); 
helloword-debug.js 13| console. log(t.name); 
helloword.js 14 t.sayO; 

15 | }); 





D {} Line 10, Column 1 


> this 
v test 四 
p proto : test 
» this 
v test Ø 
name: "node debug" 
» say: function () 4 
b». proto : test 


最 简单 的 实现 继承 的 方法 ， 当 然 多 重 继承 mixin 也 可 以 是 这 样 的 原理 


1.2.3. 测试 express helloworld 
这 种 测试 一 般 都 是 看 request 里 的 params，query 和 body 等 
准备 工作 


npm init 
npm install --save express 
touch express-helloworld.js 


测试 express-helloworld.js 代 码 
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var express - require('express'); 
var app - express(); 


app.get('/',function(req,res)( 
res.send('hello,world'); 
1; 


app.listen(5008); 


执行 ,安装 服务 器 自动 重 载 模块 


npm install -g supervisor 
supervisor express-helloworld.js 


打开 浏览 器 访问 http:/127.0.0.1:5008/ 就 会 看 到 helloworld 返 回 
此 时 终止 supervisor express-helloworld.js ,使 用 ctrl + c 终止 。 


然后 使 用 node-inspect 调 试 


? node-debug-tutorial git:(master) ? node-debug express-helloworld.js 
Node Inspector is now available from http://localhost:8080/debug?port-5858 


Debugging '"express-helloworld.js^ 


debugger listening on port 5858 




















增加 断 点 
jSowees|Conole a a a 
Sources | Content s... Snippets jus | express-helloworld.js x | 
> © (no domain) 1 (function (exports, require, module, _ filename, _ dirname) 4 var express = require('express'); 
Aan 2 var app = express(); 
v O file:// 3 
v JUsers/sang/workspace/githut — 4 app.get('/',function(req,res)( 
a res. send('hello,world'); 
*| node modules/express 62) 
[+] express-helloworld.js 7 
国 extend.js p akah a 


=| helloword-debug.js 
=) helloword.js 


使 用 curl 来 模拟 get 请 求 ， 增 加 一 个 参数 test， 便 于 一 会 的 debug 


curl -G -d "test-string" http://127.0.0.1:5008/ 


此 时 浏览 器 页 面 会 停 在 断 点 处 ， 在 console 里 输入 req.query 即 可 以 查 到 参数 








» 
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C 32 C f D localhost:8080/debug?port-5858 
HI Apps cS node.js 4f pixijs @ 24:49 - Pomotodo 





| | API Reference $8 Mox 



















Snippets |l! |[4] 





express-helloworld.js x 









> (2 (no domain) 









1 (function (exports, require, module, 
v Q file:// : var app = express(); 
v [-3Users/sang/workspace/githuE — 4 app.get('/',function(reqg,res)1 
> (-1node modules/express - 
本 express-helloworld.js 7 /-— | 
3] extend.js : cid 


=| helloword-debug.js 


= helloword.js 


© O | Line 5, Column 1 
» req.query 
v Object 
test: "string" 
». proto : Object 
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1.3. 测试 驱动 开发 


。 tdd 

。 bdd 

e PUB E E 
1.3.1. 测试 框 梁 


e nodeunit 
e mocha 


1.3.2. 更 多 测试 


npm install --save-dev chai 

npm install --save-dev sinon 

npm install --save-dev supertest 
npm install --save-dev zombie 


1.3.3. 代码 覆盖 这 
修改 Gulpfile.js 


e auto test 
e 代码 测试 覆盖 率 


npm install --save-dev gulp 
npm install --save-dev gulp-mocha 
npm install --save-dev gulp-istanbul 


创建 gulpfilejs 


var gulp - require('gulp'); 
var istanbul = require('gulp-istanbul'); 
var mocha - require('gulp-mocha'); 


gulp.task('test', function (cb) { 
gulp.src(['db/**/*.3s']) 
.pipe(istanbul()) // Covering files 
.on('finish', function () 4 
gulp.src(['test/*.js']) 
.pipe(mocha()) 
.pipe(istanbul.writeReports()) // Creating the reports after tests runned 
.on('end', cb); 
}); 
}); 


gulp.task('default',['test'], function() { 
gulp.watch(['./db/**/*','./test/**/*'], ['test']); 


3); 


gulp.task('watch',['test'], function() 4 
gulp.watch(['./db/**/*','./test/**/*'], ['test']); 


3); 


测试 
node modules/.bin/gulp 这 时 ， 你 试 试 修改 测试 或 源 文件 试 试 ， 看 看 会 不 会 自动 触发 测试 
当然 ， 如 果 你 喜欢 只 是 测试 一 次 ， 可 以 这 样 做 


node_modules/.bin/gulp test 如 果 你 不 熟悉 gulp， 可 以 再 这 里 https://github.com/isting/js- 
tools-best-practice/blob/master/doc/Gulp.md 学 习 


修改 package.json 


"scripts": { "start": "./node modules/.bin/supervisor ./bin/www", "test": "./node modules 


E E) 
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1.4. 资源 
e debugger 官 方 文档 
e node-inspector 仓 库 地 址 
e nodeunit 
e mocha 
e https://github.com/baryon/tracer 
e http://www.habdas.org/node-js-debugging-primer/ 
e https://github.com/visionmedia/mocha 
e http://visionmedia.github.io/mocha/ 


e http://mochajs.org/ 

e https://github.com/chaijs/chai 

e http://chaijs.com/ 

e http://sinonjs.org/ 

e http://zombie.labnotes.org/ 

e https:;//github.com/tj/supertest (api test 文 档 ) 

e https://github.com/tj/superagent/blob/master/test/node/agency.js (api test 示 例 ) 
e https://github.com/iSting/js-tools-best-practice/blob/master/doc/Gulp.md 

e https://github.com/SBoudrias/gulp-istanbul 


